negotiator.boaframework

Class OpponentModel

java.lang.Object

negotiator.boaframework.OpponentModel

Direct Known Subclasses:

AgentLGModel, AgentXFrequencyModel, BayesianModel, CUHKFrequencyModelV2, CycleModel, DefaultModel, FSEGABayesianModel, HardHeadedFrequencyModel, IAMhagglerBayesianModel, NashFrequencyModel, NoModel, OppositeModel, ParallelOM, PerfectIAMhagglerBayesianModel, PerfectModel, PerfectScalableBayesianModel, ScalableBayesianModel, SmithFrequencyModel, SmithFrequencyModelV2

public abstract class OpponentModel
extends java.lang.Object

Describes an opponent model of an agent of the BOA framework. Tim Baarslag, Koen Hindriks, Mark Hendrikx, Alex Dirkzwager and Catholijn M. Jonker. Decoupling Negotiating Agents to Explore the Space of Negotiation Strategies

Author:

Alex Dirkzwager, Mark Hendrikx

Field Summary

Fields

Modifier and Type	Field and Description
protected NegotiationSession	negotiationSession Reference to the negotiation state
protected UtilitySpace	opponentUtilitySpace Reference to the estimated opponent's utility state

Constructor Summary

Constructors

Constructor and Description
OpponentModel()

Method Summary

Methods

Modifier and Type	Method and Description
void	cleanUp() Removes references to the objects used by the opponent model.
double	getBidEvaluation(Bid bid) Determines the utility of a bid according to the preference profile.
double[]	getIssueWeights()
java.lang.String	getName()
UtilitySpace	getOpponentUtilitySpace()
double	getWeight(Issue issue) Returns the weight of a particular issue in the domain.
void	init(NegotiationSession negotiationSession) Alternative init method to initialize the model without setting parameters.
void	init(NegotiationSession negotiationSession, java.util.HashMap<java.lang.String,java.lang.Double> parameters) Initializes the model.
boolean	isCleared()
void	setOpponentUtilitySpace(BilateralAtomicNegotiationSession fNegotiation) Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.
void	setOpponentUtilitySpace(UtilitySpace opponentUtilitySpace) Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.
void	updateModel(Bid opponentBid) Method used to update the opponent model.
abstract void	updateModel(Bid bid, double time) Method used to update the opponent model.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

negotiationSession

protected NegotiationSession negotiationSession

Reference to the negotiation state

opponentUtilitySpace

protected UtilitySpace opponentUtilitySpace

Reference to the estimated opponent's utility state

Constructor Detail

OpponentModel

public OpponentModel()

Method Detail

init

public void init(NegotiationSession negotiationSession,
        java.util.HashMap<java.lang.String,java.lang.Double> parameters)
          throws java.lang.Exception

Initializes the model. The init method should always be called after creating an opponent model.

Parameters:

negotiationSession - reference to the state of the negotiation

parameters -

Throws:

java.lang.Exception

init

public void init(NegotiationSession negotiationSession)

Alternative init method to initialize the model without setting parameters.

Parameters:

negotiationSession - reference to the state of the negotiation

updateModel

public void updateModel(Bid opponentBid)

Method used to update the opponent model.

Parameters:

opponentBid -

updateModel

public abstract void updateModel(Bid bid,
               double time)

Method used to update the opponent model.

Parameters:

bid - to update the model with.

time - at which the bid was offered.

getBidEvaluation

public double getBidEvaluation(Bid bid)

Determines the utility of a bid according to the preference profile.

Parameters:

bid - of which the utility is calculated.

Returns:

Utility of the bid

getOpponentUtilitySpace

public UtilitySpace getOpponentUtilitySpace()

Returns:

the estimated utility space of the opponent

setOpponentUtilitySpace

public void setOpponentUtilitySpace(BilateralAtomicNegotiationSession fNegotiation)

Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.

Parameters:

fNegotiation -

setOpponentUtilitySpace

public void setOpponentUtilitySpace(UtilitySpace opponentUtilitySpace)

Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.

Parameters:

opponentUtilitySpace -

getWeight

public double getWeight(Issue issue)

Returns the weight of a particular issue in the domain.

Parameters:

issue - from which the weight should be returned

Returns:

weight of the given issue

getIssueWeights

public double[] getIssueWeights()

Returns:

set of all estimated issue weights.

cleanUp

public void cleanUp()

Removes references to the objects used by the opponent model.

isCleared

public boolean isCleared()

Returns:

if the opponent model is in a usable state.

getName

public java.lang.String getName()

Returns:

name of the opponent model.